-2005-12-19 Matthias Clasen <mclasen@redhat.com>
+2005-12-20 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/tmpl/gtkcombo.sgml: Small additions
+2005-12-19 Matthias Clasen <mclasen@redhat.com>
+
* gdk-pixbuf/tmpl/module_interface.sgml:
* gdk-pixbuf/gdk-pixbuf-sections.txt:
* gdk-pixbuf/tmpl/animation.sgml: Small additions/fixes.
<!-- ##### VARIABLE gdk_threads_mutex ##### -->
<para>
The #GMutex used to implement the critical region for
-gdk_threads_enter()/gdk_threads_leave(). This variable should not be
-used directly — consider it private.
+gdk_threads_enter()/gdk_threads_leave().
</para>
+@Deprecated: 2.4: This variable should not be used directly
+ — consider it private.
+
<!-- ##### FUNCTION gdk_threads_set_lock_functions ##### -->
<para>
@entry: the text entry field.
@list: the list shown in the drop-down window.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### ARG GtkCombo:allow-empty ##### -->
<para>
</para>
@Returns: a new #GtkCombo.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_popdown_strings ##### -->
@combo: a #GtkCombo.
@strings: a list of strings, or %NULL to clear the popup list
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_value_in_list ##### -->
@combo: a #GtkCombo.
@val: %TRUE if the value entered must match one of the values in the list.
@ok_if_empty: %TRUE if an empty value is considered valid.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_use_arrows ##### -->
@combo: a #GtkCombo.
@val: %TRUE if the arrow keys can be used to step through the items in
the list.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_use_arrows_always ##### -->
@combo: a #GtkCombo.
@val: unused
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_case_sensitive ##### -->
@combo: a #GtkCombo.
@val: %TRUE if the text in the list items is case sensitive.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_set_item_string ##### -->
@combo: a #GtkCombo.
@item: a #GtkItem.
@item_value: the string to place in the #GtkEntry when @item is selected.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_combo_disable_activate ##### -->
</para>
@combo: a #GtkCombo.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
@combobox: the object which received the signal.
+<!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
+<!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
<!-- ##### ARG GtkComboBox:active ##### -->
<para>
</para>
+<!-- ##### ARG GtkComboBox:tearoff-title ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkComboBox:wrap-width ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION gtk_combo_box_set_title ##### -->
+<para>
+
+</para>
+
+@combo_box:
+@title:
+
+
+<!-- ##### FUNCTION gtk_combo_box_get_title ##### -->
+<para>
+
+</para>
+
+@combo_box:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_combo_box_set_focus_on_click ##### -->
<para>
@GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
@GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
+@GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS:
<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
<para>
</para>
+<!-- ##### ARG GtkFileChooserButton:focus-on-click ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkFileChooserButton:title ##### -->
<para>
@n_chars:
+<!-- ##### FUNCTION gtk_file_chooser_button_get_focus_on_click ##### -->
+<para>
+
+</para>
+
+@button:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_file_chooser_button_set_focus_on_click ##### -->
+<para>
+
+</para>
+
+@button:
+@focus_on_click:
+
+
@data: The data to pass to the function.
@destroy: Function to call when the timeout is destroyed or %NULL.
@Returns: A unique id for the event source.
-@Deprecated: Use g_timeout_add_full() instead.
+@Deprecated: 2.4: Use g_timeout_add_full() instead.
<!-- ##### FUNCTION gtk_timeout_add ##### -->
@function: The function to call periodically.
@data: The data to pass to the function.
@Returns: A unique id for the event source.
-@Deprecated: Use g_timeout_add() instead.
+@Deprecated: 2.4: Use g_timeout_add() instead.
<!-- ##### FUNCTION gtk_timeout_remove ##### -->
</para>
@timeout_handler_id: The identifier returned when installing the timeout.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### FUNCTION gtk_idle_add ##### -->
@function: The function to call.
@data: The information to pass to the function.
@Returns: a unique handle for this registration.
-@Deprecated: Use g_idle_add() instead.
+@Deprecated: 2.4: Use g_idle_add() instead.
<!-- ##### FUNCTION gtk_idle_add_priority ##### -->
@function: The function to call.
@data: Data to pass to that function.
@Returns: A unique id for the event source.
-@Deprecated: Use g_idle_add_full() instead.
+@Deprecated: 2.4: Use g_idle_add_full() instead.
<!-- ##### FUNCTION gtk_idle_add_full ##### -->
@data: Data to pass to that function.
@destroy: Function to call when the timeout is destroyed or %NULL.
@Returns: A unique id for the event source.
-@Deprecated: Use g_idle_add_full() instead.
+@Deprecated: 2.4: Use g_idle_add_full() instead.
<!-- ##### FUNCTION gtk_idle_remove ##### -->
</para>
@idle_handler_id: Identifies the idle function to remove.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### FUNCTION gtk_idle_remove_by_data ##### -->
</para>
@data: remove the idle function which was registered with this user data.
-@Deprecated: Use g_idle_remove_by_data() instead.
+@Deprecated: 2.4: Use g_idle_remove_by_data() instead.
<!-- ##### FUNCTION gtk_input_add_full ##### -->
@destroy: callback function to call with @data when the input
handler is removed, or %NULL.
@Returns: A unique id for the event source; to be used with gtk_input_remove().
-@Deprecated: Use g_io_add_watch_full() instead.
+@Deprecated: 2.4: Use g_io_add_watch_full() instead.
<!-- ##### FUNCTION gtk_input_remove ##### -->
</para>
@input_handler_id: Identifies the function to remove.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### MACRO GTK_PRIORITY_REDRAW ##### -->
to avoid redrawing a widget just before resizing (and therefore redrawing
it again).
</para>
-<note><para>
-This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
-</para></note>
+
+@Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
Use this for high priority timeouts. This priority is never used inside
GTK+ so everything running at this priority will be running before anything
inside the toolkit.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
-</para></note>
</para>
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
+
<!-- ##### MACRO GTK_PRIORITY_INTERNAL ##### -->
<!-- ##### MACRO GTK_PRIORITY_DEFAULT ##### -->
<para>
Default priority for idle functions.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
-</para></note>
</para>
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
+
<!-- ##### MACRO GTK_PRIORITY_LOW ##### -->
<para>
Priority for very unimportant background tasks.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_LOW instead.
-</para></note>
</para>
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_LOW instead.
+
<!-- ##### FUNCTION gtk_key_snooper_install ##### -->
</para>
+<!-- ##### ARG GtkMenu:horizontal-padding ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkMenu:vertical-offset ##### -->
<para>
</para>
+<!-- ##### ARG GtkNotebook:reorderable ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkNotebook:scrollable ##### -->
<para>
@GTK_IN_DESTRUCTION: the object is currently being destroyed. This is used
internally by GTK+ to prevent reinvokations during destruction.
-@GTK_FLOATING: the object is orphaned. Objects that take strong hold of an
- object may call g_object_ref_sink(), to convert the floating reference into
- a regular one, if they believe they are nearly primary ownership of the
- object.
-GTK_CONNECTED: signals are connected to this object.
-@GTK_RESERVED_1: reserved for future use
@GTK_RESERVED_2: reserved for future use
<!-- ##### MACRO GTK_OBJECT_FLAGS ##### -->
<!-- ##### ENUM GtkArgFlags ##### -->
<para>
Possible flags indicating how an argument should be treated.
-Deprecated in favor of #GParamSpec features.
</para>
@GTK_ARG_READABLE: the argument is readable. (i.e. can be queried)
and is redundant with #GTK_ARG_CONSTRUCT.
@GTK_ARG_CHILD_ARG: an argument type that applies to (and may be different for)
each child. Used by #GtkContainer.
+@Deprecated: Use corresponding #GParamSpec features instead
<!-- ##### FUNCTION gtk_object_new ##### -->
<para>
</para>
@object: the object to sink.
-@Deprecated: Use g_object_ref_sink() instead
+@Deprecated: 2.10: Use g_object_ref_sink() instead
<!-- ##### FUNCTION gtk_object_ref ##### -->
should be accessed using the functions below.
</para>
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
<para>
</para>
@Returns: a new #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_get_menu ##### -->
@option_menu: a #GtkOptionMenu.
@Returns: the #GtkMenu associated with the #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_set_menu ##### -->
@option_menu: a #GtkOptionMenu.
@menu: the #GtkMenu to associate with the #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_remove_menu ##### -->
</para>
@option_menu: a #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_set_history ##### -->
@option_menu: a #GtkOptionMenu.
@index_: the index of the menu item to select. Index values are from 0 to n-1.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_get_history ##### -->
</para>
+<!-- ##### ARG GtkRange:lower-stepper-sensitivity ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkRange:update-policy ##### -->
<para>
</para>
+<!-- ##### ARG GtkRange:upper-stepper-sensitivity ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:color-hash ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkSettings:gtk-alternative-button-order ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-color-scheme ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-enable-animations ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-show-input-method-menu ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSettings:gtk-show-unicode-menu ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-timeout-initial ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSettings:gtk-timeout-repeat ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
<para>
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### STRUCT GtkStatusIcon ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GtkStatusIcon::activate ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+
+<!-- ##### SIGNAL GtkStatusIcon::popup-menu ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkStatusIcon::size-changed ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GtkStatusIcon:blinking ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:file ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:icon-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:pixbuf ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:stock ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:storage-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:visible ##### -->
+<para>
+
+</para>
+
<!-- ##### FUNCTION gtk_status_icon_new ##### -->
<para>
@h:
+<!-- ##### FUNCTION gtk_style_lookup_color ##### -->
+<para>
+
+</para>
+
+@style:
+@color_name:
+@color:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_style_lookup_icon_set ##### -->
<para>
@arg2:
@arg3:
+<!-- ##### ARG GtkTextBuffer:has-selection ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkTextBuffer:tag-table ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION gtk_text_buffer_get_has_selection ##### -->
+<para>
+
+</para>
+
+@buffer:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_text_buffer_place_cursor ##### -->
<para>
</para>
@values:
+@Returns:
@toggleaction: the object which received the signal.
+<!-- ##### ARG GtkToggleAction:active ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkToggleAction:draw-as-radio ##### -->
<para>
@tree_view:
+<!-- ##### FUNCTION gtk_tree_view_get_headers_clickable ##### -->
+<para>
+
+</para>
+
+@tree_view:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_tree_view_set_headers_clickable ##### -->
<para>